home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 1 / Cream of the Crop 1.iso / EDITOR / FUGUE_3.ARJ / WF.014 < prev    next >
Text File  |  1990-11-04  |  9KB  |  277 lines
  1. .f3                              - # -              Chapter 14 - TOC
  2. .rm70
  3. .mt5
  4. .mb5
  5. .pl66
  6. .tc
  7. .tc 14. TABLE OF CONTENTS .................................#
  8. CHAPTER 14   TABLE OF CONTENTS
  9.  
  10. Many documents you produce will require a table of contents. This can
  11. be achieved by identifying the table of contents entries, and
  12. executing a Generate Table Of Contents command (Ctrl F5). The table of
  13. contents files have the same name as the file you are generating for,
  14. but have the extension .TOC for the main one and the extensions .TO1
  15. up to .TO9 for the ancillary ones. Only those files you request will
  16. be produced.
  17.  
  18. Table of contents files can be included in your document by use if the
  19. file include (.FI) dot command, and if so included, will be printed
  20. when you print the document. However, if you change the document, you
  21. will need to re-create the table of contents files, since this is not
  22. done automatically.
  23.  
  24. Level Numbers can be generated automatically if you wish, or you can
  25. put them in yourself. Automatic level numbers can be numbers, letters
  26. or Roman numerals.
  27.  
  28. .tc    Identifying Table of Contents Entries ..............#
  29. Identifying Table of Contents Entries
  30.  
  31. Before you can generate a table of contents, you need to identify each
  32. entry that you want in the table of contents. This is done with the
  33. .TC dot command. Separate each entry from the dot command by at least
  34. one space. If you wish to include the page number, merely put the
  35. character # in the line where you wish it to print. You can include
  36. special print control functions and characters for special effects
  37. during printing. To indent an entry in the table of contents, just put
  38. extra spaces after the TC
  39.  
  40.   for example:
  41.  
  42.     .TC INTRODUCTION.............................#
  43.  
  44.     .TC      Part 1..............................#
  45.  
  46.     Your table of contents entries will look like this:
  47.  
  48.     INTRODUCTION.............................1
  49.          Part 1..............................2
  50.  
  51.  
  52. If you follow the dot command immediately by a number 1 to 9, the
  53. table of contents line will not be written to the .TOC file, but
  54. instead to a separate file with the extension .TO1 to .TO9 depending
  55. on the digit. This allows you more flexibility in generating tables of
  56. contents, for example a separate list of tables, a separate list of
  57. illustrations and so on.
  58.  
  59. .CP7
  60.   for example:
  61.  
  62.     .TC1 figure 1.1 Sales vs Expenditure ... #
  63.     .tc2 table 1.1 Sales vs Expenditure  ... #
  64.  
  65.   will produce in file.TO1 the line
  66.  
  67.        figure 1.1 Sales vs Expenditure ... 4
  68.  
  69.   and in file.TO2 the line
  70.  
  71.        table 1.1 Sales vs Expenditure  ... 4
  72.  
  73.   assuming that the page number is 4.
  74.  
  75. Word Fugue will gather all the entries for a numbered .TC command and
  76. place them into separate files. All these files have the same name as
  77. the original document, but the extension is set to a numbered
  78. extension: .TO1 , .TO2 and so on.
  79.  
  80. .tc    Automatic Level Numbering ..........................#
  81. Automatic Level Numbering
  82.  
  83. Level numbers can be generated automatically by use of the @L print
  84. function. You can have up to 9 different level numbers, in differing
  85. types and styles. This is discussed more fully below. You place the
  86. level number in brackets : {.@L1} for level 1 to {.@L9} for level 9.
  87. They will be expanded at printing or TOC generation, depending whether
  88. they are in the text body or the .TC lines.
  89.  
  90. .tc       Style of Numbering ..............................#
  91.   Style of Numbering
  92.  
  93.   Style can be any of Office, Decimal (default), or Nodot.
  94.  
  95.   Office prints only one number for each level, followed by a dot.
  96.   Thus:
  97.  
  98.          {.@L1}
  99.            {.@L2}
  100.              {.@L3}
  101.  
  102.            gives
  103.            1.
  104.              1.
  105.                1.
  106.  
  107.   NoDot is similar to Office, except that the dot (.) is not printed.
  108.   Thus:
  109.  
  110.          {.@L1}
  111.            {.@L2}
  112.              {.@L3}
  113.  
  114.            gives
  115.            1
  116.              1
  117.                1
  118.  
  119.   Decimal produces all levels separated by dots (.)
  120.   Thus:
  121.  
  122.          {.@L1}
  123.            {.@L2}
  124.               {.@L3}
  125.  
  126.             gives
  127.  
  128.          1.
  129.            1.1.
  130.               1.1.1.
  131.  
  132.  
  133.   You set this with the .TS command
  134.  
  135.          .TS O   for  Office
  136.       or .TS D   for  Decimal
  137.       or .TS N   for  Nodot
  138.  
  139.   The style you last set remains in effect for all level numbers until
  140.   you change it. Thus if you wish to have decimal numbering for the
  141.   first three levels, and Office numbering for the remainder, you will
  142.   need to use .TS D when you start, .TS O when you reach level 4, and
  143.   .TS D when you return to a level lower than 4. You will need to
  144.   continue toggling the style throughout the document.
  145.  
  146. .tc       Types of Numbering ..............................#
  147.   Types of Numbering
  148.  
  149.   Each level can have its own type of numbering, independent of all
  150.   the other levels. The available types of numbering are:-
  151.  
  152.     R      Roman uppercase       eg   III.
  153.     r      roman lowercase       eg   iii.
  154.     N or n Numeric (default)     eg   3.
  155.     A      Alphabetic uppercase  eg   C.
  156.     a      alphabetic lowercase  eg   c.
  157.  
  158.   You set this with the .TL command:
  159.  
  160.               .TLn x
  161.                         where n is 1 to 9 (the level)
  162.                               x is R,r,N,n,A,a (as above)
  163.  
  164.   NOTE These letters are case sensitive, so that r (lowercase) will
  165.        give lowercase Roman, while R (uppercase) will give uppercase
  166.        Roman.
  167.  
  168. .tc       Set Start Numbers ...............................#
  169.   Set Start Numbers
  170.  
  171.   Each level defaults to starting at number 1. However, you can start
  172.   each level at a different number, eg if you have divided your
  173.   document up into different parts, and only want to print a part of
  174.   it.
  175.  
  176.   Note that referencing a lower numbered level will automatically
  177.   reset all higher numbered levels to 1.
  178.  
  179.   For alphas, use the equivalent number eg a = 1, b=2, z=26 etc. The
  180.   level number is always stored internally as a number, and is
  181.   converted on printing to the appropriate text.
  182.  
  183. .CP5
  184.   You set this with .TN command:
  185.  
  186.             .TNn  i
  187.                        where n is 1 to 9 (the level)
  188.                              i is the start number
  189.  
  190. .tc       Examples ........................................#
  191.   Examples
  192.  
  193.      OFFICE
  194.  
  195.           .TS Office
  196.           .TL2 r
  197.           .tl3 a
  198.              {.@L1} this is level 1
  199.                {.@L2} this is level 2
  200.                   ({.@L3}) this is level 3
  201.  
  202.                     produces
  203.  
  204.              1. this is level 1
  205.                i. this is level 2
  206.                   (a.)  this is level 3
  207.  
  208.  
  209.      NODOT
  210.  
  211.           .TS Nodot
  212.           .TL2 r
  213.           .tl3 a
  214.              {.@L1} this is level 1
  215.                {.@L2} this is level 2
  216.                   ({.@L3}) this is level 3
  217.  
  218.                     produces
  219.  
  220.              1 this is level 1
  221.                i this is level 2
  222.                   (a) this is level 3
  223.  
  224.  
  225. .CP8
  226.      DECIMAL
  227.  
  228.           .TS Decimal
  229.           .TL2 r
  230.           .tl3 a
  231.              {.@L1} this is level 1
  232.                {.@L2} this is level 2
  233.                   ({.@L3}) this is level 3
  234.  
  235.                     produces
  236.  
  237.              1. this is level 1
  238.                1.i. this is level 2
  239.                   (1.i.a.) this is level 3
  240.  
  241.  
  242.   Embed the commands in the .TC lines for the correct numbers to
  243.   appear in table of contents.
  244.  
  245.              .tc {.@L1} this is level 1 ................... #
  246.              {.@L1} this is level 1
  247.              .tc  {.@L2} this is level 2 .................. #
  248.                {.@L2} this is level 2
  249.              .tc     ({.@L3}) this is level 3 ............. #
  250.                   ({.@L3}) this is level 3
  251.  
  252.  
  253. .CP5
  254. .tc    Producing a Table of Contents ......................#
  255. Producing a Table of Contents
  256.  
  257. To produce the table of contents, enter the command Ctrl F5. You will
  258. be prompted for the name of the file for which to generate the TOC.
  259. Enter the name of the file. Note if you are working on the file,
  260. please save it first so that the up to date version is used.
  261. Production of tables of contents happen in foreground, so you will not
  262. be able to do any editing while this happens. However, table of
  263. contents generation usually takes no more than a few seconds.
  264.  
  265. Word Fugue will gather all the entries for a numbered .TC command and
  266. place them into separate files. All these files have the same name as
  267. the original document, but the extension is set to a numbered
  268. extension: .TO1 , .TO2 and so on.
  269.  
  270. These files should be included in your document via the .FI command.
  271.  
  272. TIP - if you are writing a book or similar, with several chapters, set
  273.       each chapter up as a separate file, and create a master file
  274.       that includes each chapter, table of contents & index file by
  275.       use of .FI commands. Generate the table of contents for the top
  276.       level file, and all lower level files will be included.
  277.